home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 685 / diskprint / english / diskprint.doc < prev    next >
Text File  |  1995-03-18  |  19KB  |  424 lines
  1.      ######  ####  #####  ##   ##  ######  ######  #### ##   ## ######
  2.      ##   ##  ##  ##      ##  ##   ##   ## ##   ##  ##  ###  ##   ##
  3.      ##   ##  ##   #####  #####    ##   ## ##   ##  ##  #### ##   ##
  4.      ##   ##  ##       ## ##  ##   ######  ######   ##  ## ####   ##
  5.      ##   ##  ##  ##   ## ##   ##  ##      ##   ##  ##  ##  ###   ##
  6.      ######  ####  #####  ##   ##  ##      ##   ## #### ##   ##   ##
  7.  
  8.      SHAREWARE                                EVALUATION VERSION 3.5e
  9.  
  10.                          copyright by Jan Geissler
  11.                           Hermann-Rombach-Str. 17
  12.                         D-7120 Bietigheim-Bissingen
  13.                               (West) Germany
  14.                     FIDO: "Jan Geissler" @ 2:247/706.5
  15.  
  16. ==========================================================================
  17.  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT
  18. --------------------------------------------------------------------------
  19.  
  20.                         This program is SHAREWARE!
  21.  
  22. This is an  evaluation version.  If you  like  DiskPrint,  please  send me
  23. the contribution of $20/$25 (see registration form). As all other program-
  24. mers, I am also dependent upon the sale of my program, and as I still  be-
  25. lieve in the system of shareware or tryware. There has not been much feed-
  26. back to my program yet, and so I am thinking about to sell future develop-
  27. ments to commercial software companies because it's not worth  working  on
  28. a program for about  two years just to get some 60 bucks out of it (that's
  29. all I got from non-german speaking countries yet).
  30.  
  31. The Amiga  is a  great computer and  its FD  scene is unique, so keep this
  32. software system alive and support programmers to keep on developing share-
  33. ware!
  34.  
  35.  
  36.                              --- DISTRIBUTION ---
  37.  
  38. DiskPrint is shareware. This evaluation version was designed to be redis-
  39. tributed only under the following restrictions:
  40.  
  41. · The whole package is complete and is contained in a separate drawer.
  42.   The package includes the following files:
  43.  
  44.      FredFish_580-650.cc      DiskPrint_NTSC.info    MuchMore
  45.      Disk.info                DiskPrint_PAL          Registration
  46.      DiskPrint.doc            DiskPrint_PAL.info     Registration.info
  47.      DiskPrint.doc.info       InstallLibrary         reqtools.library
  48.      DiskPrint.hlp            InstallLibrary.info    Title
  49.      DiskPrint_NTSC           Labels.info            Title.info
  50.      Version                  Version.info           XIcon
  51.  
  52. · None of the files listed is changed in any  way  without  the written
  53.   permission of the author (Jan Geissler). The package may  be archived
  54.   with a program like LHA, LHARC or ZOO as long as the all files of the
  55.   package remain unchanged (= can be extracted to their original state)
  56.   and no files are added to the archive.
  57.  
  58. · Download form BBSs is allowed as long as no download fee is  charged.
  59.  
  60. · A fee may be charged to recover distribution costs. The fee  for this
  61.   distribution must not be more than obtaining a public domain diskette
  62.   from Fred Fish.
  63.  
  64.  
  65. -------------------------------------------------------------------------
  66.  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT NOTICE  *  COPYRIGHT
  67. ==========================================================================
  68.  
  69.  
  70. I.       Configuration
  71.  
  72. II.      About DiskPrint
  73.  
  74. III.     Getting started
  75.  
  76. IV.      DiskPrint main window
  77.  
  78. V.       The Directory Tool
  79.  
  80. VI.      The defaults window
  81.  
  82. VII.     Editing the data mem
  83.  
  84. VIII.    Multiple printing / Print a range
  85.  
  86. IX.      Keyboard functions
  87.  
  88. =========================================================================
  89.  
  90.  
  91. I .   C O N F I G U R A T I O N
  92.  
  93. This program runs on  all Amigas with  AmigaDos 1.2/1.3/2.0.
  94.  
  95. "reqtools.library" is needed for DiskPrint to run.
  96. "asl.library" (under OS2.0) is optional.
  97.  
  98. The "printer.device" is used so your printer driver should be set properly.
  99. What  you  also  need  are  labels to print on. Possible label formats are:
  100. 70x70 mm, 70x50 mm and 70x36mm (sorry, I don't know the size in inch...)
  101.  
  102.  
  103. I I .   A B O U T   T H E    P R O G R A M
  104.  
  105. DiskPrint is used for  printing 3,5" and 5.25" disk labels. It was designed
  106. mainly for the  public domain area  (for printing labels for FD-disks). The
  107. main feature  is that label data libraries are included (over  2500  labels
  108. in  the  registered  version)  and  can be loaded into memory so labels for
  109. special FD-disks, e.g. Fishdisks, are available without  use  of  the  key­
  110. board  and  without  waiting  for AmigaDos until the disk directory is read
  111. in. (though DiskPrint is able to read in disk directories).
  112. The  easiest  way to figure out what advantages DiskPrint has is to run the
  113. program and print out some Fish-labels...
  114.  
  115.  
  116. I I I .   G E T T I N G   S T A R T E D
  117.  
  118. The Program can be started either from Workbench or from CLI.
  119.  
  120. Workbench: Use your mouse and click on the DiskPrint icon or
  121.            double-click (or shift-click) a label data file
  122.  
  123. CLI: "DiskPrint [-m]/[-i]/[-mi]/[-im]"
  124.      Options:
  125.      -m   Allocates 80000 bytes as data mem for label data libraries.
  126.           (Memory requester won't appear)
  127.      -i   Start DiskPrint "sleeping" (=iconify).
  128.      -im or -mi  a combination of -m and -i
  129.      Version 3.5 detaches from the CLI.
  130.  
  131. The prefs entered in the "preferences" window of DiskPrint are being stored
  132. in the s: directory of the disk (or harddisk) you booted from.
  133.  
  134. Note to users of V3.4.3 or earlier versions:
  135. Because the format of this file has canged since earlier versions, you have
  136. to reconfigure DiskPrint 3.5 first.
  137.  
  138.  
  139. I V .   T H E   D I S K P R I N T   W I N D O W
  140.  
  141. In  the top of the DiskPrint window there are 21 names of FD-disk series. I
  142. know most of them are german, but only two americans sent me  the share for
  143. diskprint so  there seems to be no interest for my program non-german spea-
  144. king countries. Three of these gadgets on the right are configurable.
  145. If selected, the name of the gadget is copied into the "diskname" gadget.
  146.  
  147. The gadget  containing  a <B>  specifies  the  width of the diskname on the
  148. label (normal width (10 cpi) / double width (5 cpi))
  149.  
  150. Below  this  are  two  gadgets  where  you can skip forward/backward by one
  151. label in data memory. (These functions are also available on the arrow keys
  152. left/right)
  153. Between  these  there's  a gadget with a number in it (described below). If
  154. you  hit  this gadget a label with this number will be searched in data me-
  155. mory.
  156. Below you'll find the "disktype" gadget where general information about the
  157. disk contents should be given, for example "backup disk",  "public domain",
  158. "amiga FD software". Three descriptions can be defined in the prefs window.
  159. They are copied in the disktype gadget by selecting the @-Gadgetnext to the
  160. disktype. (keyboard equivalent: cursor up)
  161.  
  162. Below the disktype gadget are seven string gadgets  where  detailed  infor-
  163. mation about the contents should be given (for example program names, copy-
  164. right, ...).
  165. All string gadgets can be cleared by selecting the "C" gadget. The disktype
  166. gadget is filled with a default then.
  167. Next to these string gadgets are fourteen small gadgets with which boldface
  168. and color printing  can be  enabled/disabled. If  selected,  black  gadgets
  169. mean boldface and blue gadgets mean color on.
  170.  
  171. The  disk number which can be increased/decreased with the proprtional gad-
  172. get above is stored next to the diskname gadget. This number is appended to
  173. the diskname by clicking on the number.
  174. "+500" increased/decreases this number by 500.
  175.  
  176. By clicking on the number below the diskname gadget this number is searched
  177. in a loaded label file.
  178.  
  179. Labels in the data memeory can be marked by changing the "-> D" gadget into
  180. a big "D" and then write the label into the memory. (see below).
  181.  
  182.  
  183. The Sleep/Iconify function closes  the  DiskPrint  screen and opens a small
  184. window on the workbench screen to minimize  CPU and memory usage.  Activate
  185. this little window and then press the right button to wake up DiskPrint.
  186.  
  187. DiskPrint has some more functions:
  188.  
  189. - Clear data mem            Clears the data mem. The labels (currently in
  190.                             memory) will be lost!
  191. - Load label data           Load a label data file from disk into memory
  192.                             (requester will open)
  193. - Save label data           Save a label data file on disk
  194.                             (!!! disabled in demo version)
  195. - Delete file               Delete a label file (-> requester)
  196. - >Label into mem           Write the (in the window) actually displayed
  197.                             label into mem at the position by using the
  198.                             write mode shown in the mode gadget (described
  199.                             below)
  200. - Print label               Print the label on your printer. Uses the
  201.                             printer.device. Your printer should be set
  202.                             correctly with "preferences" !
  203. - Mode: append/edit         This is the mode used at "Write into mem":
  204.                             * if in append mode: the label will be appen-
  205.                               ded after the last label in memory
  206.                               (the actual position in memory is ignored)
  207.                              -> use this to append new labels to the end of
  208.                                 your data file
  209.                             * if in edit mode: the label in the actual
  210.                               position will be overwritten by the displayed
  211.                               label
  212.                              -> use this to edit old label data. But please
  213.                                 be careful...
  214. - Fish Contents             Loads in the contents file of a fishdisk and
  215.                             copies them to the string gadgets.
  216.                             Also loads in version numbers of the files if
  217.                             given in the contents file.
  218.                             The drive where the contents will be loaded from
  219.                             can be specified with the small gadget next to
  220.                             the FishContents gadget (0 means df0:, 1 means df1:
  221.                             and so on, "C" means the drive specified in the
  222.                             prefs window).
  223. - Search by name            Search for an ASCII text in data memory
  224.                             * Search first: Start searching at the first
  225.                               label in data memory
  226.                             * Search next: Start searching at the actual
  227.                               position in memory
  228. - AutoIncrease              Increase the disk no. by 1 if the "clear"
  229.                             gadget is used
  230. - AutoWrite                 Activates the above listed function "Write
  231.                             into mem" automatically if the "return"-key is
  232.                             pressed in the last contents gadget
  233.                             (be careful: the write mode is relevant)
  234. - Directory tool            Load in a disk directory. See below!
  235. - Preferences               Edit defaults. See below!
  236. - Edit data mem             Edit labels in data mem or change marks; see
  237.                             below.
  238. - Multiprint win            Print one label multiple or
  239.                             print a range of labels. See below.
  240.  
  241.  
  242. V .   T H E   D I R E C T O R Y    T O O L
  243.  
  244. Since release 2.7 of DiskPrint it is also  possible to read in disk  direc-
  245. tories  and  use  them to create disk labels. "Load rootdir" reads the root
  246. directory of the drive specified in the gadget on the right. A  maximum  of
  247. 36 filenames is listed below the string  gadgets. Click  on these  names to
  248. copy them into the  string  gadgets. "Undo" removes  the  last copied name.
  249. "Clear gadgets" clears the string gadgets. "OK" copies the label from this
  250. window  into  the  main window, "Cancel" doesn't. "df0:" changes the drive.
  251. (Only df0, df1, df2, df3 possible - send me a message if other  drives  are
  252. necessary).
  253. Subdirectorys are printed in another color (OS2.0-cols:  white).  Use  left
  254. mousebutton  to  transfer  name  into the contents fields, click with RIGHT
  255. MOUSEBUTTON to change into the subdirectory.
  256. "Root dir" changes into the root, "parent" into the parent dir.
  257.  
  258. The root directory of a disk is being buffered.
  259.  
  260. Since version 3.5, the directory tool has its own preferences where several
  261. filters (filter ".dok",".doc",".txt",".info" files) and the sorting  method
  262. (alphabetically  or  file type) can be enabled. These preferences are  also
  263. stored in the  DiskPrint  preferences  file if saved in the main prefrences
  264. window.
  265.  
  266. Since V3.5 ASCII text files  can be  shown with  the directory  tool  if an
  267. external text viewer (for  example  MuchMore  by Fridtjof  Siebert which is
  268. included  in the  DiskPrint  package)  was  entered in the main preferences
  269. window. To  view an ascii file click on "Textfile" and then on the textfile
  270. to be shown.
  271.  
  272.  
  273.  
  274. V I .  D I S K P R I N T    P R E F E R E N C E S    W I N D O W
  275.  
  276. I tried to make DiskPrint's usage as easy as possible so I created the file
  277. "DiskPrint.def"  which is  stored  in  the S: directory of the SYS-disk (or
  278. harddisk) you booted from.
  279.  
  280. Data to be edited:
  281. Label size:       It is possible to print on three different label sizes.
  282.                   The sizes are 70x70 mm, 70x50 mm and 70x36 mm (with or
  283.                   without headline)
  284. Send additional CR: An additional linefeed is sent to ensure compatibility
  285.                   to some "exotic" labels where the space between the
  286.                   labels is non-standard (ca. 6 mm).
  287. Filrequester:     Filerequester to be used for loading/saving/deleting.
  288.                   ReqTools is default. ASL only available under OS 2.0
  289.                   and Req only avaible is the "req.library" is available
  290.                   in LIBS:
  291. Pathname:         The pathname of a directory containing all label
  292.                   data files (used by the filerequester)
  293. ASCII Reader:     Enter the path & name of your ascii text reader with
  294.                   "%s" where the filename of the file to be shown
  295.                   will be inserted instead of "%s".
  296.                   For example "Dh0:c/Muchmore %s".
  297.                   (Press the return key in this gadget and DiskPrint will
  298.                   check and correct your entry!)
  299. DiskTypes:        ASCII text, will be copied in the DiskType-Gadget every
  300.                   time the "C" (clear)-Gadget is activated.
  301.                   3 possible contents.
  302. Double height ON: Enter hexcode for double height here (see below)
  303.              OFF: Hexcode to turn double height off (see below)
  304. Color #:          Number of the color if color printing is enabled in
  305.                   the main window.
  306. Perforation skip OFF:
  307.                   Hexcode to turn perforation skip of your printer off
  308.                   (Or use it for your own purposes, e.g. another linefeed
  309.                   or a color printing). see below.
  310.                   This sequence (if turned on) is sent to the printer
  311.                   before the first linefeed of a label is sent. (When
  312.                   "Print label" is selected.)
  313. Test label pos.:  Prints out two lines to help you to center the label in
  314.                   your printer.
  315. Custom-Names 1-3: 3 self-definable names (out of 21 in the main window)
  316. Default amount of datamem: Enter your preferred amount of mem.
  317.                   (Memwin won't open if entered)
  318. Iconifywin X- and Y-Pos: Position (upper left edge) where the iconify-
  319.                   window will appear.
  320.  
  321.  
  322. ON/OFF-GADGETS:
  323. Letter Quality      LQ on/off (printer)
  324. Double height       Print diskname normal (off) / double height (on)
  325.                     (if hexcode is entered properly)
  326. Headline: 1 blank   Print one blank left of the headline (if "on")
  327.                     (leaves some space to the edge of the label)
  328. Headline: 15 cpi    Print headline condensed (on) or normal width (off)
  329. Perf. skip off      Send hex-sequence (see above) to printer if "on"
  330. App. # to diskno    Copy "#"-char left of diskno. if arrow gadget (to copy
  331.                     the diskno into the diskname field) is hit (and if
  332.                     turned on)
  333. Send n/60 + lf      Send code entered in "Code for n/60"
  334. Create Icons        Create Icons if a label file is saved
  335. Center printout     If on, the printout is centered.
  336. Text on backside    Print information on 70x70 labels whether the disk
  337.                     is write enabled or not.
  338.  
  339.  
  340. * HEXCODES:
  341.  
  342. The printer.device doesn't support some printer functions like double
  343. height or perforation off (or special functions of YOUR printer). You can
  344. enter hexcodes there to use these functions.
  345. Please refer to your printer manual.
  346. An example (here: Epson LQ 850)
  347. In your manual:    Double height
  348.                    ON:  Hex: 1b 77 01
  349.                    OFF: Hex: 1b 77 00
  350. so enter in the "ON:" field: 1b7701
  351. (don't leave spaces, use only chars from 0 to 9 and a to f. Always enter
  352. pairs of two digits, e.g. zero should be entered as "00")
  353. If your input was wrong, the screen flashes and the field is cleared).
  354.  
  355. Hexcodes for Epson LQ-850:
  356. Double height on:  1b7701
  357.              off:  1b7700
  358. Perf.skip    off:  1b4f
  359.  
  360.  
  361.  
  362. V I I .   E D I T I N G    D A T A    M E M
  363.  
  364. In this window you can edit the contents of the data mem. The functions
  365. always depend on the label shown in this window.
  366.  
  367. - Delete label:   Delete the actual label.
  368. - Insert blank:   Insert a blank label at the actual position.
  369. - Clone label:    "double" the actual label (insert the actual label
  370.                   at the actual position)
  371. - Cancel:         Exit this window
  372.  
  373. - Clear all:      Clear all marks in label memory.
  374. - Mark all:       Set all marks (mark all labels) in label memory.
  375. - reverse:        invert all marks.
  376.  
  377.  
  378.  
  379.  
  380. V I I I .   M U L T I P L E    P R I N T  /   P R I N T    A   R A N G E
  381.  
  382. - PRINT A LABEL MULTIPLE
  383.   Enter the number of labels to print and use the gadgets to adjust
  384.   the label you wish to print. Then press the "Print labels" gadgets.
  385.  
  386. - PRINT A RANGE OF LABELS
  387.   Adjust the first and last label to print.
  388.   Pressing "Print labels" starts to print all labels from the first
  389.   to the last one.
  390.  
  391. - PRINT MARKED
  392.   All marked labels stored in the data memory are printed.
  393.  
  394.  
  395.  
  396. I X .   K E Y B O A R D
  397.  
  398. When no string gadget is active, some gadget functions are also available
  399. on the keyboard as equivalents to some gadgets.
  400.  
  401. ESC-key            Leave DiskPrint (= Close-gadget)
  402. F1                 Preferences window
  403. F10                Repeat last function
  404. 4 (num. kpd)       Jump to first label in data memory
  405. 6 (num. kpd)       Jump to last label
  406. 5 (num. kpd)       Toggle mark
  407. + (num. kpd)       Increase number by 1
  408. - (num. kpd)       Decrease number by 1
  409. ] (num. kpd)       Increase number by 10
  410. [ (num. kpd)       Decrease number by 10
  411. * (num. kpd)       Increase/Decrease Number by 500
  412. / (num. kpd)       Search number in data memory
  413. TAB-key            Sleep
  414. DEL-key            Clear input fields (= gadget "C")
  415. Cursor-keys lt/rt  One label back/one forward
  416. Cursor-key up      Change disktype
  417.  
  418. ___________________________________________________________________________
  419.  
  420. Enjoy!                                              Jan Geissler, 21-May-92
  421.  
  422.  
  423.  
  424.